Release 10.1A: OpenEdge Data Management:
DataServer for ODBC

Updating a schema holder

The Update/Add Table Definitions utility allows you to update a schema holder to reflect changes that you make to the data definitions in your ODBC data source.

Note: Using this utility to update the schema holder is the only way to make sure that your applications can access modifications or additions to an ODBC data source.

The Update/Add utility allows you to:

Add object definitions from the ODBC data source to a schema holder. Use this option if you add a new table or view to the data-source data definitions and want the schema holder to reflect the change.
Update existing object definitions in a schema holder to reflect a change in the supporting data-source object definitions.

To update a schema holder:

Access the Data Administration tool, if you are not already there, and select DataServer ODBC Utilities Update/Add Table Definitions. The following dialog box appears:



Type preselection criteria values into the fields as required. These values preselect the data-source objects that the utility uses to update the schema holder. By default, the wildcard symbol (*) appears; it specifies that the utility uses all of the objects in the data source.

Note that for a DB2/400 data source, you must type the name of the library in the Owner/Library field. For all other DB2 data sources, you must type the name of the DB2 database in this field. If the DB2 database name is different from the authorization ID for the tables being selected, type the authorization ID in the Owner/Library field.

Note: For each of the three entry fields in the dialog box, if you enter a value that consists only of wild cards, you might degrade the performance of the database when you perform a schema pull. (It will include system catalog files that are not typically included in user databases.)
Choose OK. A dialog box lists the objects and table information that you have preselected, for example:



Select the objects that you want to update, then choose OK. When the update completes, OpenEdge returns to the Data Administration main window.

When the update completes, OpenEdge reminds you to check the ds_upd.e file. This file contains information about the tables that did not support record IDs as well as other warnings.

When you update a definition, OpenEdge overwrites the old definition with the new one based on the current data-source object. It also preserves the OpenEdge-specific table information. As a result, if you want to add a new column to a table in your ODBC data source and then update the definition, you do not have to reenter all of the OpenEdge-specific information for the previously existing columns (fields) in the definition.

Note: When you update a table in the schema holder with the Update/Add Table Definitions utility, the information for the user-defined ROWID is lost. You must reselect an index to support the ROWID.